home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 3.7 / Buddy API Docs.swf / texts / 1298.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  4.7 KB  |  203 lines
  1. 61
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. RunProgram 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baRunProgram runs an external application and can optionally wait until the other 
  20. --- RECORDSEPARATOR ---
  21. program quits before continuing.
  22. --- RECORDSEPARATOR ---
  23.  
  24. --- RECORDSEPARATOR ---
  25. Usage:
  26. --- RECORDSEPARATOR ---
  27.  
  28. --- RECORDSEPARATOR ---
  29. Result = baRunProgram( Program , State,  Wait )
  30. --- RECORDSEPARATOR ---
  31.  
  32. --- RECORDSEPARATOR ---
  33. Arguments:
  34. --- RECORDSEPARATOR ---
  35.  
  36. --- RECORDSEPARATOR ---
  37. String, String, Integer. 
  38. --- RECORDSEPARATOR ---
  39. Program is the name of the program to run. 
  40. --- RECORDSEPARATOR ---
  41. State is how the program is to appear. Can be one of the following: 
  42. --- RECORDSEPARATOR ---
  43. Can be one of these:
  44. --- RECORDSEPARATOR ---
  45.  
  46. --- RECORDSEPARATOR ---
  47. Windows
  48. --- RECORDSEPARATOR ---
  49.  
  50. --- RECORDSEPARATOR ---
  51. "Normal" 
  52. --- RECORDSEPARATOR ---
  53. shows in its usual state. 
  54. --- RECORDSEPARATOR ---
  55. "Hidden" 
  56. --- RECORDSEPARATOR ---
  57. is not visible. 
  58. --- RECORDSEPARATOR ---
  59. "Maximised" 
  60. --- RECORDSEPARATOR ---
  61. shows as a maximised window. 
  62. --- RECORDSEPARATOR ---
  63. "Minimised" 
  64. --- RECORDSEPARATOR ---
  65. shows as an minimised icon.
  66. --- RECORDSEPARATOR ---
  67.  
  68. --- RECORDSEPARATOR ---
  69. Macintosh
  70. --- RECORDSEPARATOR ---
  71.  
  72. --- RECORDSEPARATOR ---
  73. The State argument is ignored, 
  74. --- RECORDSEPARATOR ---
  75. Wait determines whether the Director or Authorware program continues, or if it 
  76. --- RECORDSEPARATOR ---
  77. waits for the external program to finish before continuing. Can be either true or 
  78. --- RECORDSEPARATOR ---
  79. false.
  80. --- RECORDSEPARATOR ---
  81.  
  82. --- RECORDSEPARATOR ---
  83. Returns:
  84. --- RECORDSEPARATOR ---
  85.  
  86. --- RECORDSEPARATOR ---
  87. Integer. 
  88. --- RECORDSEPARATOR ---
  89. If successful returns a meaningless number greater than 31. 
  90. --- RECORDSEPARATOR ---
  91. If the return is less than 32, then an error occurred. On
  92. --- RECORDSEPARATOR ---
  93.  Windows
  94. --- RECORDSEPARATOR ---
  95. , some possible 
  96. --- RECORDSEPARATOR ---
  97. error numbers are listed here. 
  98. --- RECORDSEPARATOR ---
  99. 0 
  100. --- RECORDSEPARATOR ---
  101. System was out of memory, executable file was corrupt, or relocations were invalid. 
  102. --- RECORDSEPARATOR ---
  103. 1 
  104. --- RECORDSEPARATOR ---
  105. Unspecified error. 
  106. --- RECORDSEPARATOR ---
  107. 2 
  108. --- RECORDSEPARATOR ---
  109. File was not found. 
  110. --- RECORDSEPARATOR ---
  111. 3 
  112. --- RECORDSEPARATOR ---
  113. Path was not found. 
  114. --- RECORDSEPARATOR ---
  115. 5 
  116. --- RECORDSEPARATOR ---
  117. Attempt was made to dynamically link to a task, or there was a sharing or network-protection 
  118. --- RECORDSEPARATOR ---
  119. error. 
  120. --- RECORDSEPARATOR ---
  121. 6 
  122. --- RECORDSEPARATOR ---
  123. Library required separate data segments for each task. 
  124. --- RECORDSEPARATOR ---
  125. 8 
  126. --- RECORDSEPARATOR ---
  127. There was insufficient memory to start the application. 
  128. --- RECORDSEPARATOR ---
  129. 10 
  130. --- RECORDSEPARATOR ---
  131. Windows version was incorrect. 
  132. --- RECORDSEPARATOR ---
  133. 11 
  134. --- RECORDSEPARATOR ---
  135. Executable file was invalid. Either it was not a Windows application or there was an error in 
  136. --- RECORDSEPARATOR ---
  137. the .EXE image. 
  138. --- RECORDSEPARATOR ---
  139. 12 
  140. --- RECORDSEPARATOR ---
  141. Application was designed for a different operating system. 
  142. --- RECORDSEPARATOR ---
  143. 13 
  144. --- RECORDSEPARATOR ---
  145. Application was designed for MS-DOS 4.0. 
  146. --- RECORDSEPARATOR ---
  147. 14 
  148. --- RECORDSEPARATOR ---
  149. Type of executable file was unknown. 
  150. --- RECORDSEPARATOR ---
  151. 15 
  152. --- RECORDSEPARATOR ---
  153. Attempt was made to load a real
  154. --- RECORDSEPARATOR ---
  155. -mode application (developed for an earlier version of 
  156. --- RECORDSEPARATOR ---
  157. Windows). 
  158. --- RECORDSEPARATOR ---
  159. 16 
  160. --- RECORDSEPARATOR ---
  161. Attempt was made to load a second instance of an executable file containing multiple data 
  162. --- RECORDSEPARATOR ---
  163. segments that were not marked read-only. 
  164. --- RECORDSEPARATOR ---
  165. 19 
  166. --- RECORDSEPARATOR ---
  167. Attempt was made to load a compressed executable file. The file must be decompressed 
  168. --- RECORDSEPARATOR ---
  169. before it can be loaded. 
  170. --- RECORDSEPARATOR ---
  171. 20 
  172. --- RECORDSEPARATOR ---
  173. Dynamic-link library (DLL) file was invalid. One of the DLLs required to run this application 
  174. --- RECORDSEPARATOR ---
  175. was corrupt. 
  176. --- RECORDSEPARATOR ---
  177. 21 
  178. --- RECORDSEPARATOR ---
  179. Application requires 32-bit extensions. 
  180. --- RECORDSEPARATOR ---
  181. On
  182. --- RECORDSEPARATOR ---
  183.  Macintosh
  184. --- RECORDSEPARATOR ---
  185. , an error always returns 0.
  186. --- RECORDSEPARATOR ---
  187.  
  188. --- RECORDSEPARATOR ---
  189. Examples:
  190. --- RECORDSEPARATOR ---
  191.  
  192. --- RECORDSEPARATOR ---
  193. Director: 
  194. --- RECORDSEPARATOR ---
  195. set OK = baRunProgram( "Notepad.exe", "maximised", false ) 
  196. --- RECORDSEPARATOR ---
  197. Authorware: 
  198. --- RECORDSEPARATOR ---
  199. OK := baRunProgram( "Notepad.exe", "maximised", false )
  200. --- RECORDSEPARATOR ---
  201.  
  202. --- RECORDSEPARATOR ---
  203. (continued next page)